home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / blrut17.lzh / BLRUT17.DOC < prev    next >
Text File  |  1990-07-18  |  9KB  |  291 lines
  1. *----------------------------------------------
  2. *   BLRUT17.DOC
  3. *---------------------------------------------------
  4. *   this is the documentation for the 24 utilities
  5. *   accompanying this file in BLRUT17.ARC,
  6. *   as of 06/12/90 - 10:45 pm
  7. *---------------------------------------------------
  8. *   all of these utilities were written in
  9. *   68000 assembly language using
  10. *   the ASSEMPRO assembler from ABACUS. 
  11. *---------------------------------------------------
  12. *   My system configuration is:
  13. *   an ATARI 1040ST with built in DS drive ( 'a' ),    
  14. *   an SC1224 color monitor, 
  15. *   an SF314 DS diskette drive ( 'b' ),
  16. *   an ATARI SH305 Megafile 30 ( 'c', 'd', and 'e' )
  17. *   an EasyData 2400 BD modem,
  18. *   and a Panasonic KX-P1080i printer.
  19. *---------------------------------------------------
  20. *   All these utilities were tested on this
  21. *   configuration, but i must admit,
  22. *   not always thoroughly enough.
  23. *---------------------------------------------------
  24. *   All of these utilities are interactive,
  25. *   which means that all the information
  26. *   they need from the user will be
  27. *   requested at run time, so all the user
  28. *   need do, is run them, and reply to
  29. *   the queries.
  30. *---------------------------------------------------
  31. *    All Utilities will work on a
  32. *    color or monochrome monitor,
  33. *    and under low, medium, or high 
  34. *    resolution.
  35. *---------------------------------------------------
  36. *    All the utilities that copy             
  37. *    or compare diskettes,
  38. *    ( ACDAF, CD, CDAF, CTD ),
  39. *    assume either two SS or two DS     
  40. *    diskette drives as drives 'a' and 'b',
  41. *    They also assume 80 tracks, 
  42. *    9 sectors a track.
  43. *    They will not work with mixed SS/DS drives.
  44. *---------------------------------------------------
  45. *    The programs that copy files
  46. *    ( ACF, BUD, CF ),
  47. *    and the programs that list/print files
  48. *    ( ALPAF, ALPTF, LPAF, LPTF, PMTF ),
  49. *    use free RAM as a file buffer.
  50. *    If there isn't at least
  51. *    10000 bytes free RAM available,
  52. *    the programs give up.
  53. *---------------------------------------------------
  54. *    For the List/Print Utilities,
  55. *    List  = output to the screen,
  56. *    Print = output to the printer.
  57. *---------------------------------------------------
  58. *    For the present, the drives
  59. *    allowed are 'a' thru 'p'.
  60. *---------------------------------------------------
  61. *   C H E E R S  ! ! !
  62. *---------------------------------------------------
  63. *
  64. *   If you have any questions, suggestions, gripes -
  65. *
  66. *   If you wish the source for these utilities -
  67. *
  68. *   If you wish to make a monetary contribution -
  69. *
  70. *   write:
  71. *
  72. *   Bud Rasmussen
  73. *   3795 Saxon Drive S.
  74. *   Salem, OR 97302
  75. *
  76. *   or call me at home:
  77. *
  78. *   503-585-1515 
  79. *
  80. *  ( Voice ONLY - NOT a BBS )
  81. *
  82. *---------------------------------------------------
  83. *
  84. *   I can also be reached through the
  85. *   Salem Public Library BBS where I
  86. *   am the Atari ST Co-Sysop -
  87. *
  88. *   The SPL BBS has four lines:
  89. *
  90. *   503-588-6130
  91. *   503-588-6081
  92. *   503-588-6086
  93. *   503-588-6092
  94. *
  95. *   300-2400 baud - 8-N-1
  96. *---------------------------------------------------
  97.  
  98.  
  99. *--------------------------*
  100. *   Program Descriptions   *
  101. *--------------------------*
  102.  
  103.  
  104. 01.  ACDAF.PRG   ( AES Copy Diskette And Format - SS/DS )
  105.  
  106.      This program is a track at a time sector copier that will
  107.      copy a diskette from drive 'a' to drive 'b' or vice versa,
  108.      if the drives are similar types, ( SS to SS or DS to DS ).
  109.      It will also format the output diskette while copying,
  110.      if the user wishes.
  111.      It communicates with the user via alert boxes.
  112.  
  113.  
  114. 02.  ACF.PRG   ( AES Copy File )
  115.  
  116.      This program is a file copier which will copy a file on any
  117.      valid drive to any other valid drive.
  118.      It uses file selector boxes to select the input/output file names.
  119.      Since the output file name must be selected, 'ACF' can function as
  120.      a copier/renamer.
  121.  
  122.   
  123. 03.  ALPAF.PRG      ( AES List / Print Any File )
  124.  
  125.      This program will list or print the ascii / hex representation
  126.      of any file on any valid drive.
  127.      It uses a file selector box to select the file to be 
  128.      listed or printed.
  129.  
  130.   
  131. 04.  ALPTF.PRG      ( AES List / Print Text File )
  132.  
  133.      This program will list or print any standard text file on
  134.      any valid drive. It uses a file selector box to select the
  135.      file to be listed or printed.
  136.  
  137.   
  138. 05.  ALTF.PRG      ( AES List Text File )
  139.  
  140.      This program will list any standard text file on
  141.      any valid drive. It lists forward/backward by line, page, or file.
  142.      It uses a file selector box to select the
  143.      file to be listed.              
  144.  
  145.  
  146. 06.  BUD.TOS     ( Back Up Directory )
  147.  
  148.      This program will backup ( copy ) an entire directory at a time
  149.      from drive ( a thru p )  to drive ( a thru p ). The user has 
  150.      the option of specifying individual output paths for each file
  151.      or a single path for all output files. If the output is to drive
  152.      "a" or "b", the user has the option of erasing all files on the 
  153.      output diskette, before the copy. If the output is to drive
  154.      "a" or "b", and the diskette fills up while writing an output file,
  155.      the user has a choice of inserting a formatted diskette and
  156.      continuing, or quitting ( in either case the partial output file
  157.      is erased ).
  158.  
  159.  
  160. 07.  CD.TOS      ( Copy Diskette - SS/DS )
  161.  
  162.      This program is a track at a time sector copier that will
  163.      copy a diskette from drive 'a' to drive 'b' or vice versa
  164.      without formatting, if the drives are similar types,
  165.      ( SS to SS or DS to DS ).
  166.  
  167.  
  168. 08.  CDAF.TOS    ( Copy Diskette And Format - SS/DS )
  169.  
  170.      This program is a track at a time sector copier that will
  171.      copy a diskette from drive 'a' to drive 'b'
  172.      or vice versa, if the drives are similar types,
  173.      ( SS to SS or DS to DS ). It will also format the output
  174.      diskette while copying, if the user wishes.
  175.  
  176.  
  177. 09.  CF.TOS      ( Copy File )
  178.  
  179.      This program will copy a file on any drive to any other
  180.      drive. Since the output file path\name must be keyed in,
  181.      'CF' can function as a copier/renamer.
  182.  
  183.  
  184. 10.  CTD.TOS     ( Compare Two Diskettes - SS/DS )
  185.  
  186.      This program will do a track at a time sector compare of     
  187.      two diskettes in drive 'a' and 'b', if the drives are
  188.      similar types, ( SS to SS or DS to DS ).
  189.      It is most useful after a
  190.      sector copy to check the accuracy of the copy.
  191.  
  192.  
  193. 11.  DDI.TOS     ( Display Disk Information )
  194.  
  195.      This program will display just about all the information it is
  196.      possible to garner from disk drives ( a thru p ).
  197.  
  198.  
  199. 12.  DFM.TOS     ( Display Free Memory )
  200.  
  201.      This program displays the total amount of free memory.
  202.  
  203.  
  204. 13.  DKV.TOS     ( Display Key Value )
  205.  
  206.      This program will display the ascii code and the scan code for
  207.      any key on the Atari ST keyboard.
  208.     
  209.  
  210. 14.  DSE.TOS       ( Disk Sector Edit )
  211.  
  212.      This program will allow the user to modify any sector on disk
  213.      drives ( a thru p ).
  214.  
  215.      It has the following options:
  216.  
  217.      read a sector  
  218.      display 1st half of sector
  219.      display 2nd half of sector
  220.      modify sector
  221.      write modified sector
  222.  
  223.  
  224. 15.  EADF.TOS      ( Erase All Diskette Files )
  225.  
  226.      This program will erase all files that are in the root directory 
  227.      on drive 'a' or 'b' only.
  228.  
  229.  
  230. 16.  LD.TOS        ( List Directory )
  231.  
  232.      This program will list any directory on disk drives ( a thru p ),
  233.      sorted by name.               
  234.  
  235.  
  236. 17.  LPAD.TOS      ( List / Print All Directories )
  237.  
  238.      This program will list or print all directories on drives ( a thru p ).
  239.      The user has the option of the output being sorted by name or not.
  240.      
  241.  
  242. 18.  LPAF.TOS      ( List / Print Any File )
  243.  
  244.      This program will list or print the ascii / hex representation of
  245.      any file on any valid drive.
  246.  
  247.  
  248. 19.  LPD.TOS       ( List / Print Directory )
  249.  
  250.      This program will list or print any directory on drives ( a thru p ).
  251.      The user has the option o